home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs05.d81 / evsbasic.arc / EVSKEYWORDS.J-P < prev    next >
Text File  |  2009-10-10  |  10KB  |  273 lines
  1. ---------------------------------------
  2.  
  3. LINE <xpos>, <ypos> [[TO <xpos>, <ypos>]...]
  4.  
  5. The LINE statement draws a straight line on the bitmap screen, using the
  6. current pen, starting at the current cursor position and ending at <xpos>,
  7. <ypos>.  LINE will always plot at least one point, even if the specified
  8. <xpos>, <ypos> is the same as the current cursor position.  After the line
  9. is drawn the current cursor position is moved to <xpos>, <ypos>.
  10.  
  11. A LINE statement may optionally be followed by as many <xpos>, <ypos> pairs
  12. separated by the TO keyword as will fit on a program line.  This results in
  13. a series of lines connected end-to-end.
  14.  
  15. The allowed range of <xpos>, <ypos> pairs depends on the current logical
  16. screen coordinates.  The default range is 0,0 to 319,199.
  17.  
  18. LINE functions only in graphic modes 4 and 5.
  19.  
  20. Examples:
  21.  
  22. 10 LOCATE 0,0: LINE 319,199
  23. 20 LINE 10*X, Y+5
  24. 30 LOCATE X0,Y0: LINE X1,Y1 TO X2,Y2 TO X0,Y0
  25.  
  26. ---------------------------------------
  27.  
  28. LOAD [<filename$>] [,<dvc>] [,<addr>]
  29.  
  30. The V2 Basic LOAD command has been modified to search for <filename$> on
  31. the current default device if <dvc> is not specified.  There is no other
  32. change in its behavior.
  33.  
  34. Examples:
  35.  
  36. 10 LOAD "MYPROGRAM"
  37. 20 LOAD "THISPROGRAM",9
  38. 30 LOAD "B*",8,1
  39.  
  40. ---------------------------------------
  41.  
  42. LOCATE <xpos>, <ypos>
  43.  
  44. LOCATE sets the current cursor position in all graphic modes.  In text
  45. modes the allowed range of <xpos>, <ypos> is from 0,0 to 39,24.  In bitmap
  46. modes the range of <xpos>, <ypos> depends on the current logical screen
  47. coordinates.  The default range is 0,0 to 319,199.
  48.  
  49. Examples:
  50.  
  51. 10 GRAPHIC 0: LOCATE 1, 10: PRINT "HELLO"
  52. 20 LOCATE I*10, I+5:
  53.  
  54. ------------------------------------------
  55.  
  56. LOOP [WHILE/UNTIL <exp>]
  57.  
  58. The LOOP statement marks the end of a DO/LOOP repeat structure.  The LOOP
  59. statement is physically the last statement of the loop.  Every LOOP must
  60. have one, and only one, matching DO statement.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. The basic DO/LOOP structure is unconditional, and all program statements
  69. between a DO statement and a LOOP statement will repeatedly execute in
  70. order forever (or until the program is halted by the STOP key).  This is
  71. useful in some cases, but more often a program exits from a DO/LOOP when
  72. some condition is fulfilled.
  73.  
  74. A LOOP statement may optionally be followed by either the WHILE or UNTIL
  75. conditional statements.  A WHILE conditional will continue repeating the
  76. loop only so long as <exp> is true.  An UNTIL conditional will continue
  77. repeating the loop only so long as <exp> is false.  If the only exit from a
  78. DO/LOOP is a conditional statement after the LOOP statement, the entire
  79. loop will always be executed at least once.
  80.  
  81. When a DO/LOOP is terminated by WHILE, UNTIL, or EXIT, normal program
  82. execution continues starting with the next statement after the LOOP
  83. matching the DO.
  84.  
  85. DO/LOOPs may be nested within each other or within FOR/NEXT loops, and
  86. FOR/NEXT loops may be nested within DO/LOOPs.  The total number of active
  87. nested loops of both kinds should not exceed nine.
  88.  
  89. Examples:
  90.  
  91. 10 DO: PRINT "HELLO": LOOP
  92. 20 DO: GET A$: LOOP UNTIL A$<>""
  93.  
  94. ---------------------------------------
  95.  
  96. MAK$(<length>, <char$>)
  97.  
  98. MAK$() returns a string consisting of the first character of <char$>
  99. repeated <length> times.  <Length> may range from 0 to 255.  If <length> is
  100. zero or <char$> is the null string, MAK$() returns the null string.
  101.  
  102. Examples:
  103.  
  104. 10 A$ = MAK$(100, " ")
  105. 20 PRINT MAK$(A, A$)
  106.  
  107. ---------------------------------------
  108.  
  109. PAGE
  110.  
  111. In all graphic modes the PAGE statement clears the screen and places the
  112. cursor at the upper left hand corner.  PAGE also fills color memory with
  113. the current ink 1 color, although this is not usually apparent.
  114.  
  115. Examples:
  116.  
  117. 10 PAGE
  118. 20 IF A$="Y" THEN PAGE
  119. 30 PAGE: LINE 319,199
  120.  
  121. ---------------------------------------
  122.  
  123. PAINT [<filltype>] [,<boundary>]
  124.  
  125. The PAINT statement fills an area with the current pen color.  The fill
  126. starts at the current cursor position and spreads outward to the
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. <boundary>.  The fill stops when there are no more pixels to be filled.
  134. The cursor remains at its original location after filling.  PAINT functions
  135. only in graphic modes 4 and 5.
  136.  
  137. <Filltype> describes the pattern used during the fill, and may be either a
  138. number or a character.  If <filltype> is a number, it describes the
  139. "density" of the fill.  In this type of fill, pixels are filled either with
  140. pen 0 or the current pen in a fixed proportion determined by <filltype>.
  141. The value of <filltype> may range from 0 to 63, and can be thought of as
  142. the number of pixels in each 8x8 area that will be colored with pen 0.
  143. Thus, a <filltype> value of zero results in a solid fill, and a value of 32
  144. yields a checkerboard pattern.
  145.  
  146. The normal pattern generated this way is quite regular.  A much more random
  147. pattern with a very different "texture" but about the same "density" for
  148. any given value of <filltype> can be generated by adding 128 to the normal
  149. value of 0 to 63.
  150.  
  151. If <filltype> is a string, the image pattern of the first character in the
  152. string is used as the fill pattern.  An exception occurs if the first
  153. character in the string is [RVS ON] (CHR$(18)), in which case the reversed
  154. image pattern of the second character in the string will be used.  If the
  155. pattern character is non-printable, or <filltype> is the null string, an
  156. "?UNKNOWN CHAR" error will occur.
  157.  
  158. An image pattern is always taken from the currently active RAM character
  159. set.  Note that since the image pattern comes from a RAM character set it
  160. may be redefined by the IMAGE statement, and thus the actual fill pattern
  161. can be almost anything at all.
  162.  
  163. <Boundary> can range from 0 to 255, but all values over 3 result in a fill
  164. that stops at any pixel with a value greater than 0.  A <boundary> in the
  165. range 0 to 3 sets a particular pixel value that the fill will stop at. Note
  166. that a fill which stops only at a particular pixel value will fill over all
  167. areas with other pixel values.  In graphic mode 5, boundary pen values of 2
  168. or 3 will fill the entire screen.
  169.  
  170. A PAINT statement with no parameters is interpreted as the equivalent of
  171. PAINT 0,255 resulting in a solid fill that stops at any "on" pixel.
  172.  
  173. Examples:
  174.  
  175. 10 PAINT
  176. 20 PAINT 32
  177. 30 PAINT ,0
  178. 40 PAINT A(I),2
  179. 50 PAINT "A", 3-CUR(-1)
  180.  
  181. ---------------------------------------
  182.  
  183. PAPER [<border> [,<background> [,<multi/ext1> [,<multi/ext2> [,<ext3>]]]]]
  184.  
  185. The PAPER statement sets the current paper (background) colors of the
  186. screen.  This can be done at any time in any graphic mode.  However, only
  187. changes to <border> and <background> are immediately visible in all graphic
  188. modes.  The last three paper colors can be seen only in graphic modes 2 and
  189. 3.
  190.  
  191. In graphic modes 0, 1, 4, and 5 each color cell may contain only the
  192. <background> paper color.  In graphic mode 2, each color cell may also
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. display the <multi/ext1> and <multi/ext2> colors at the same time as the
  200. <background> color.  In graphic mode 3 each cell may display any one of the
  201. last four paper colors.
  202.  
  203. The default paper colors are 14, 6, 1, 2, and 3.
  204.  
  205. Paper (background) colors differ from ink (foreground) colors in that all
  206. screen color cells share the same paper color (a color cell colors either
  207. one character (text modes) or 64 pixels in an 8x8 block (bitmap modes)).
  208.  
  209. Examples:
  210.  
  211. 10 PAPER 14,6
  212. 20 PAPER 14,6,1,2,3
  213. 30 PAPER ,A
  214.  
  215. ---------------------------------------
  216.  
  217. PEN <pen>
  218.  
  219. The PEN statement sets the current pen in graphic modes 4 and 5 (in text
  220. modes the active pen is always considered to be pen 1, so that INK can
  221. change the color of PRINTed characters).  The current pen is used to alter
  222. the values of pixels on the bitmap screen, which in turn affects the color
  223. of the pixels.
  224.  
  225. <Pen> may range from 0 to 4.  Pens 0 to 3 assign specific values to pixels,
  226. and have specific colors associated with them.  Pen 0 is associated with
  227. the background paper color, which has the effect of "erasing" pixels.  Pens
  228. 1 to 3 are associated with inks 1 to 3.  Pen 4 is the "inverse" pen.
  229. Rather than having a color of its own, it changes the current value of a
  230. pixel to an "opposite" value (in graphic mode 4, pens 0 and 3 are opposites
  231. and pens 1 and 2 are opposites.  In mode 5, pen 0 is the opposite of each
  232. of the pens 1, 2, and 3).  Anything drawn with pen 4 can be erased by
  233. drawing it over a second time with pen 4.
  234.  
  235. Any color may be associated with any of the pens 0 to 3 by the PAPER and
  236. INK statements.  There is no prohibition against two or more pens sharing
  237. the same color.  However, only graphic mode 4 allows three distinct ink
  238. colors along with the paper color in the the same 8x8 pixel area colored by
  239. one color cell.  In graphic mode 5 only one ink color is allowed in a color
  240. cell along with the paper color.  Pens 2 and 3 can still be used and can
  241. still have different colors, but they behave as if they are pen 1 (a point
  242. to remember when using CUR() or PAINT, for example).  This makes it
  243. possible to use the same program in both graphic modes 4 and 5, although if
  244. the color limitations are not observed the screen may appear very different
  245. in each mode.
  246.  
  247. Examples:
  248.  
  249. 10 PEN 1
  250. 20 PEN A(I)
  251.  
  252. ---------------------------------------
  253.  
  254. POINT <xpos>, <ypos>
  255.  
  256. POINT uses the current pen to plot a single point at <xpos>, <ypos> on the
  257. bitmap screen.  The cursor is left at <xpos>, <ypos>.  This statement
  258. functions only in graphic modes 4 and 5.  The range of <xpos>, <ypos>
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265. depends on the current logical screen coordinates.  The default range is 0,
  266. 0 to 319, 199.
  267.  
  268. Examples:
  269.  
  270. 10 POINT 160,100
  271. 20 FOR I=1 TO 10: POINT X(I),Y(I): NEXT
  272.  
  273.